Atualizado em 20/06/2025 11:33

ASAAS > WEBHOOKS

 

 

Olá! Neste artigo vamos explicar a importância do campo WEBHOOKS na conta do Asaas. 

 

Quando o pagamento do Boleto, Pix ou Parcelamento é realizado, o Asaas recebe a confirmação do pagamento e repassa essa informação ao sistema TUTOR.

Para que essa comunicação entre o Asaas e o Tutor aconteça corretamente, é necessário configurar os 'WEBHOOKS' na conta do Asaas.

Caso o campo do 'WEBHOOKS' não seja preenchido corretamente, o sistema TUTOR não receberá a confirmação de que o pagamento foi realizado.

 

 

Configurando o campo do WEBHOOKS na conta do ASAAS 

1) Vá na sua conta ASAAS, no mesmo local onde você copiou o token, tem uma pasta chamada: Webhooks, clique nela

2) Agora clique: Adicionar Webhook

3) Preencha a tela com os seguintes campos:

a) Este Webhook ficará ativo ? Sim

b) Nome do Webhook: WEBOOK de Pagamentos

c) URL do Webhook: https://www.seudominio.com.br/retornoPagamentoAsaas  (seu domínio ou subdomínio da sua Loja no Tutor)

d) E-mail: seuemail@gmail.com (o e-mail do responsável da conta do Asaas)

e) Versão da API: v3

f) Token de autenticação (Opcional): Não precisa colocar nada

g) Fila de sincronização ativada ? Sim

h) Tipo de envio: Sequencial

e) Na pasta Cobranças marque as opções: PAYMENT_CONFIRMED, PAYMENT_RECEIVED, PAYMENT_REFUNDED

4) Clique no botão Salvar

 

Veja a tela como deve ficar:

 

 

 

DÚVIDAS FREQUENTES: 

 

>> Webhooks Pausado 

Se ao acessar a conta do Asaas for exibida a mensagem do print abaixo, o fluxo do Webhooks pode está pausado ou desativado.  Para maiores orientações você pode solicitar ajudar a equipe de Suporte do Asaas. 

Conforme a mensagem do Asaas sinaliza, acesse a aba LOGS de WEBHOOKs e verifique se existem Webhooks pausados ou desativados 

 

Exemplos:

 

 

 

 

 

>>  O Pagamento do Aluno está validado no Asaas, mas no Tutor o status está Aguardando Pagamento, o que pode ser?

Se o campo do WEBHOOKERS não for corretamente preenchido o Tutor não vai receber a informação de que o Boleto ou PIX foram realmente pagos. Verifique se o endereço do domínio ou subdomínio está correto no preenchimento do campo da conta do Asaas, se existem algum espaço, se a versão selecionada é a indicada neste artigo, se a URL está com o final com as letas maiúsculas e minúsculas conforme indicado neste material. 

EXEMPLO: URL do Webhook: https://www.seudominio.com.br/retornoPagamentoAsaas

 

 

>>Seu domínio é a URL do domínio/Subdomínio que está em sua Loja no Tutor no Módulo Loja e Portal >> Admin. dos Sites. 

No exemplo abaixo seria:  https://demo.sistematutor.com.br/retornoPagamentoAsaas, pois é o endereço da Loja.

 

 

 

 

 

 

 

Não encontrou o que estava procurando?